home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr38 / drmrom14.zip / DREAMROM.DOC < prev    next >
Text File  |  1995-03-30  |  43KB  |  1,005 lines
  1.  
  2.                       DreamROM v1.4 Sysop Documentation
  3.                       Copyright (c)1993-95 Andy Stewart
  4.                        Last Modified : March  30, 1995
  5.  
  6.                       ALWAYS READ the file WHATS.NEW !!!!!!
  7.  
  8.                 Frequently Asked Questions and Problem Solving
  9.                              Are in DREAMROM.FAQ.
  10.  
  11.  
  12.      ***** Welcome to DreamROM, the ULTIMATE CDrom access door! *****
  13.  
  14.    DreamROM works with RemoteAccess, GAP, PCBoard, Wildcat, Spitfire,
  15.    WWIV, TriBBS, RBBS, and any other BBS system that can generate
  16.    a DOOR.SYS, CHAIN.TXT, DORINFOx.DEF, CALLINFO.BBS, TRIBBS.SYS,
  17.    SFDOORS.DAT, etc dropfile.  DreamROM is fully multinode compatable.
  18.    DreamROM is also FULLY functional in the unregistered state.  No
  19.    Demo, no crippling, nothing!  The only difference between the
  20.    registered and unregistered versions of DreamROM is that all areas
  21.    that have [UNREGISTERED] are replaced with the Sysopname or BBSname,
  22.    and the 15 second delay when exiting the programs are eliminated.
  23.    EVERYTHING else is identical whether registered or not.
  24.  
  25.  
  26.      * Copyright and Registration Notice
  27.  
  28.      DreamROM is a copyrighted program being distributed under the
  29.      shareware concept.  The only 'difference' between DreamWARE doors
  30.      and shareware is:  Registration is still required, but the trial
  31.      period for the door is virtually indefinate.  You may test the door
  32.      online for as long as you like, and register it when you are sure
  33.      you want it to remain online, and when you can afford to register.
  34.      (I know how running a BBS can get to be a burden on your finances.)
  35.      This policy is retroactive to ALL DreamWARE doors. At any rate, try
  36.      the door until you are absolutely sure you wish the door to remain
  37.      online and can afford to register it, then, at that moment you are
  38.      required to register the door! <g>   Enjoy!
  39.  
  40.      As a shareware program, DreamROM may be freely distributed through a
  41.      BBS.  Shareware distributors may distribute copies of DreamROM on disk
  42.      for a modest disk duplication charge not to exceed $4 per disk.
  43.  
  44.  
  45.      * Warranty
  46.  
  47.      DreamROM is distributed without warranty.  In no event will Andy
  48.      Stewart, DreamWARE Communications, or anyone associated with DreamWARE
  49.      Communications or Andy Stewart be liable to you for damages,
  50.      including any loss of profits, lost savings, or other incidental or
  51.      consequential damages arising out of your use of or inability to use the
  52.      program, even if Andy Stewart, DreamWARE Communications or an authorized
  53.      representative has been advised of the possibility of such damages.
  54.      Andy Stewart and DreamWARE Communications will not be liable for any
  55.      such claim by any other party.
  56.  
  57.  
  58.      * Features
  59.  
  60.      Assembly language serial input/output routines for maximum speed.
  61.  
  62.      Fully supports high speed modems: 16550 FIFO buffering and locked
  63.      serial ports.
  64.  
  65.      Built in ANSI terminal emulator.  No need to have ANSI.SYS loaded
  66.      in memory.
  67.  
  68.      Supports all of the most popular door data file formats: TriBBS,
  69.      PCBoard, GAP, Spitfire, WildCat, RBBS, and WWIV.
  70.  
  71.      (Examples showing how the various EXEs can be run are lower in the
  72.       EXE explanations)
  73.  
  74.      * Configuration file
  75.  
  76.      Line 1:   Door data file type.
  77.      Line 2:   Path to the door data file(s).
  78.      Line 3:   BBS name.
  79.      Line 4:   Sysop's name.
  80.      Line 5:   Locked baud rate.
  81.  
  82.      As illustrated above, the door's data file type is specified in line 1
  83.      and can be PCB for PCBOARD.SYS, GAP for DOOR.SYS, SF for SFDOOR.DAT,
  84.      RBBS for DORINFOx.DEF, WC for CALLINFO.BBS, TRIBBS for TRIBBS.SYS,
  85.      or WWIV for CHAIN.TXT. The locked baud rate is specified in line 5.
  86.      If the sysop doesn't lock his serial port, he must specify 0 for the
  87.      locked baud rate.  NOTE: Although many door formats do pass the
  88.      locked baud rate in the door data files, some older formats such as
  89.      DORINFOx.DEF do not.  For conformity, it is required that you
  90.      specify the locked baud rate in line 5 and ignores any value passed
  91.      in the door data files.
  92.  
  93.      The following is a sample door configuration file:
  94.  
  95.      GAP
  96.      C:\WC\WCWORK\NODE1\
  97.      DreamNET
  98.      Andy Stewart
  99.      57600
  100.  
  101.      A file called SETUP.EXE is included to aid with writing this config.
  102.      file.  Run it, answer the questions, and let the program do the rest.
  103.  
  104.                  THIS MUST BE RUN BEFORE RUNNING DreamROM!!!
  105.  
  106.  
  107.      DreamROM can be run locally without a door data file (handy for the
  108.      sysop to use the door without logging on to the BBS) by specifying
  109.      /L after the configuration file parameter in the DOS command line.
  110.      DreamROM will request the user to enter his name before running the
  111.      door.
  112.  
  113.      Nonstandard IRQs can be used with DreamROM by specifying the IRQ
  114.      number after the  "config" parameter in the command line used to run
  115.      the door as follows:
  116.  
  117.      door config irq
  118.  
  119.      The following is a sample door batchfile file:
  120.  
  121.      @ECHO OFF
  122.      C:
  123.      CD \DREAMROM
  124.      DREAMROM NODE%WCNODEID%.CFG
  125.      CD \WC
  126.  
  127.      The above will work in a single node and multi-node operation.
  128.      For those of you not running WildCat!, use your BBS package's
  129.      %ENVIRONMENT% node setting to call the config file.
  130.  
  131.      IE:
  132.  
  133.      WILDCAT  =>  DREAMROM NODE%WCNODEID%.CFG
  134.      PCBOARD  =>  DREAMROM NODE%PCBNODE%.CFG
  135.      WWIV     =>  DREAMROM NODE%INSTANCE%.CFG
  136.  
  137.      etc.
  138.  
  139.      * Special Keys
  140.  
  141.      While a door is running, the sysop can press certain special keys to
  142.      perform a variety of functions. The following is a list of the
  143.      functions that the DreamROM special keys perform:
  144.  
  145.      Key(s)              Function
  146.  
  147.      HOME                Toggles between the user status window and a help
  148.                          display that lists the special keys.
  149.  
  150.      F6                  Takes 5 minutes away from the caller.
  151.                          NOTE:  This will NOT be returned to BBS.
  152.  
  153.      F7                  Gives 5 minutes to the caller.
  154.                          NOTE:  This will NOT be returned to the BBS.
  155.  
  156.      F9                  Quit the door and return the caller to the BBS.
  157.  
  158.      F10                 Enter chat mode.  Pressing the ESC key exits the
  159.                          chat mode.
  160.  
  161.      Alt+D               Drop to DOS.
  162.  
  163.  
  164.  
  165.    * DreamROM requires the following programs:
  166.  
  167.    PKZIP.EXE, PKUNZIP.EXE, and ARJ.EXE in your path for various
  168.    functions.
  169.  
  170.    A protocol driver in your path.  (DSZ.COM, DSZ.EXE, GSZ.COM,
  171.    GSZ.EXE, etc.) If you have an unregistered DSZ/GSZ, the YModem-G
  172.    protocol will NOT function.  Batchfiles to call the protocols should
  173.    be placed in the DreamROM main directory.  Four example batchfiles
  174.    are included.  They are Z.BAT (ZModem), Y.BAT (YModem), G.BAT
  175.    (YModem-G), and X.BAT (XModem).
  176.  
  177.    Two paramters are passed to the protocol batchfiles:
  178.  
  179.    %1 is the comport #
  180.    %2 is the filename/filelist
  181.  
  182.    For example, take Z.BAT:
  183.  
  184. rem ***********  Begin Z.BAT
  185.  
  186. @echo off
  187. goto %1
  188.  
  189. :1
  190. dsz port %1 sz %2
  191. rem   The above line calls dsz on port 1 (as passed by %1) using ZModem.
  192. rem   %2 is the file(s) to send.
  193. goto quit
  194.  
  195. :2
  196. dsz port %1 sz %2
  197. rem   The above line calls dsz on port 2 (as passed by %1) using ZModem.
  198. rem   %2 is the file(s) to send.
  199. goto quit
  200.  
  201. rem  etc, etc, etc.  The reason for the use of batchfiles, is so that
  202. rem  sysops with non-standard comport addresses and irqs can give that
  203. rem  information on the protocol commandline.  (Also, for handshakes, etc.)
  204. rem  For more information on protocols and protocol commandlines, consult
  205. rem  your protocol(s)'s documentation.  Therefore, for each comport, you
  206. rem  should have a :x section (where x is the comport #)  :1 port 1, :2
  207. rem  port 2, :3 port 3, etc...
  208. rem
  209. rem  If you have no non-standard irq, addresses, etc..  you could just use
  210. rem  a batchfile similar to this:
  211. rem
  212. rem  @echo off
  213. rem  dsz port %1 sz %2
  214.  
  215. :quit
  216. exit
  217.  
  218. rem ***********  End Z.BAT
  219.  
  220. The stock *.BAT files ship as follows:
  221.  
  222. rem *****  Begin stock Z.BAT
  223. @echo off
  224. dsz port %1 sz %2
  225. rem *****  End stock Z.BAT
  226.  
  227.  
  228.    * DreamROM Main Functions
  229.  
  230.    [L]ist Files
  231.    Allows you to select one of directories (categories) on the
  232.    current CDRom.  Once you've selected a directory, the following
  233.    options are available:
  234.  
  235.     [M]ark a file(s)
  236.     Add the file name entered to a list to be downloaded later.
  237.     Just type the letter shown to the left of the filename.
  238.  
  239.     [D]ownload file(s)
  240.     Takes you to the download area, and will allow you to download
  241.     all currently marked files, plus allow you to edit the list.
  242.     (Only on ONLINE CDs)
  243.  
  244.     [A]rchive
  245.     View contents of a .ZIP or .ARJ file, Read a file from within
  246.     the .ZIP/.ARJ file, Download a file from within the .ZIP/.ARJ
  247.     file, or Mark the .ZIP/.ARJ file for later download. (Only on
  248.     ONLINE CDs)
  249.  
  250.     - Note:  When selecting the Archive function from the Main Menu,
  251.              you MUST have an online CD loaded, or you will not be
  252.              permitted to enter the Archive area.
  253.  
  254.     [S]earch
  255.     Takes you to the Search menu, Allows you to search for text within
  256.     a directory, the entire online CD, all online CDs, or all CDs, whether
  257.     online or offline.  You may enter all or any part of a word for a
  258.     search. This feature searches filename, date, and description. The
  259.     search feature is not a DOS filename search, therefore the * and ?
  260.     wildcard characters will not work.
  261.  
  262.     - Note:  [D]ownload, [A]rchive, and [S]earch are available from the
  263.              Main Menu, and well as the Directory/Category Menu.
  264.  
  265.    [C]hange CDROM Volume
  266.    A list of disks will be displayed. The currently active disk(s)
  267.    will be marked as ONLINE.  This means you may download from it
  268.    right away. If a disk is offline, you may request files from it
  269.    by using the mark option. Change to the offline disk, then browse
  270.    the files as you would an online CD.  When you [M]ark a file, you
  271.    are asked if you would like to request the file. The sysop will
  272.    make the file(s) you request available for you at a later time.
  273.  
  274.    [O]ffline requests
  275.    Upon entering the door, you are notified if your requested file(s)
  276.    are available, and asked if you wish to download them.  If you select
  277.    'No', you may enter the Offline Request area and download the files
  278.    later in your session.
  279.  
  280.    [T] Color Toggle
  281.    Switch between ANSI and ASCII.
  282.  
  283.    [P]rotocol Change
  284.    Select the file transfer protocol.
  285.  
  286.  
  287.     * DreamROM Files Included in DRMROMxx.ZIP
  288.  
  289.               DREAMROM.EXE <= DreamROM Main Program
  290.               DREAMROM.DOC <= Sysop's Information
  291.               DREAMROM.FAQ <= DreamROM Frequently Asked Questions
  292.                               and problem solving.
  293.               ORDER.FRM    <= Registration information
  294.               COMPILE.EXE  <= Database (DRF) compiler, sysop
  295.                               setup, Audio CDRom player, etc.
  296.               COPYIT.EXE   <= DreamROM's Copy EXE.  Used Internally.
  297.               VGAROM.EXE   <= Opening screen for COMPILE.
  298.               NEWSEC.EXE   <= DRF Security Level convertor.
  299.               FIX.EXE      <= Rebuilds a DRF file after it has
  300.                               been edited (using any word processor).
  301.                               Can also wordwrap long descriptions.
  302.               DRMEDIT.EXE  <= Small texteditor used to edit *.LST
  303.                               files.  (Also used internally for
  304.                               a few other functions).  Can only be
  305.                               run fom within DreamROM and Compile.
  306.               REQCOPY.EXE  <= Sysop request check and copy program.
  307.               CHECKREQ.EXE <= Nightly event to check for expired
  308.                               requests.
  309.               RBRAIN.EXE   <= Small utility to convert RomBrain RBF
  310.                               files to DreamROM DRF files.
  311.               ROMBULL.EXE  <= Small utility to create the Online CD
  312.                               Bulletins.   Used from within DreamROM
  313.                               and can be used manually. Also can make
  314.                               WC, PCB, ANSI, and ASCII listing of ALL
  315.                               CDRoms.
  316.               SETUP.EXE    <= Small utility to create DREAMROM.CFG
  317.               DREAMROM.HLP <= Online User Help.
  318.               DRMROM.BAT   <= Example multi-node batchfile for calling
  319.                               DreamROM.  (%ENVIRONMENTS% I'm using are
  320.                               WildCat! specific, you'll need to edit
  321.                               accordingly to match your BBS's %ENVIRONMENT%
  322.                               settings.  (If any.)
  323.               G.BAT        <= YModem-G Batchfile.
  324.               X.BAT        <= XModem   Batchfile.
  325.               Y.BAT        <= YModem   Batchfile.
  326.               Z.BAT        <= ZModem   Batchfile.
  327.               WHATS.NEW    <= DreamROM history file.
  328.               FILE_ID.DIZ  <= Description File. (Long)
  329.               DESC.SDI     <= Description File. (Short)
  330.               CATALOG.TXT  <= Catalog of current DreamWARE Doors.
  331.               DISTRIB.TXT  <= Current list of DreamWARE distro sites.
  332.  
  333.    All of these files should be in this ZIP, if they are not, don't
  334.    take a chance!  Call DreamNET or a support board and download a good
  335.    copy.
  336.  
  337.  
  338.    Detailed File explanations:
  339.  
  340.    DREAMROM.EXE -  The Main DreamROM executable.  This handled all the
  341.                    caller related functions.  The database files, DRF
  342.                    files, are created with COMPILE.  DRF files are ASCII
  343.                    files that can be edited by any texteditor capable of
  344.                    loaded and editing large textfiles. Do NOT edit the
  345.                    first line!  After you edit a DRF file, run FIX.EXE
  346.                    to rebuild and rescan the file.
  347.  
  348.                    Call DreamROM in the following manner:
  349.  
  350.                    DREAMROM DREAMROM.CFG
  351.  
  352.    COMPILE.EXE  -  This is when ALL the sysop functions are.  This scans
  353.                    and builds the DRF files.  Configures all options in
  354.                    DreamROM.  Plays Audio CDs.  Setups up protocols.  Etc.
  355.  
  356.                    Call Compile in the following manner:
  357.  
  358.                    COMPILE
  359.  
  360.                    TO play an audio CD, while in COMPILE, with the audio
  361.                    CD in your FIRST CDRom drive, press F1 to begin playing,
  362.                    and F1 again to stop playing.
  363.  
  364.    DRMEDIT.EXE  -  Can only be run from within DreamROM!
  365.  
  366.    COPYIT.EXE   -  Can only be run from within DreamROM!
  367.  
  368.    VGAROM.EXE   -  Just a little 'Eye-Candy' before loading COMPILE.
  369.                    If you wish to bypass it, your system isn't a 286
  370.                    or above, it doesn't like your video card, etc...,
  371.                    just delete it and it will be bypassed.
  372.  
  373.    REQCOPY.EXE  -  This is used by the sysop to check for requested files.
  374.                    If requests are available, the sysop is prompted to copy
  375.                    the requested file(s) from the CD(s) to the hard drive.
  376.                    Call this in your logon event.  If no requests are
  377.                    available, or the user is NOT a sysop, the program will
  378.                    be bypassed.
  379.  
  380.                    Call ReqCopy in the following manner:
  381.  
  382.                    REQCOPY DREAMROM.CFG
  383.  
  384.    NEWSEC.EXE   -  Mainly used to convert pre-compiled DRF files downloaded
  385.                    from DreamNET.  Pre-compiled DRF files have all security
  386.                    levels set to 0.  To convert the DRF file to a security
  387.                    level of, say, 30, you would take the following steps.
  388.  
  389.                    Copy the DRF file (example: NOWL15.DRF) into your CDS
  390.                    subdirectory.
  391.  
  392.                    Call NEWSEC in the following manner:
  393.  
  394.                    NEWSEC NOWL15 30
  395.  
  396.                    This will convert NOWL15.DRF to a security level of 30.
  397.  
  398.    FIX.EXE      -  Rebuilds and rescans a DRF file. Use this after you
  399.                    edit a DRF file. (Will also delete any null/blank lines
  400.                    found in the DRF file)
  401.  
  402.                    Make sure the DRF file (example: NOWL15.DRF) is in your
  403.                    CDS subdirectory.
  404.  
  405.                    Call Fix in the following manner:
  406.  
  407.                    FIX NOWL15
  408.  
  409.                    Use the optional WRAP parameter if you get a DRF file
  410.                    who's description lines are too long.
  411.  
  412.                    To wrap, call Fix in this manner:
  413.  
  414.                    FIX NOWL15 WRAP
  415.  
  416.   CHECKREQ.EXE  -  Nightly event to check for expired requests.  Checks
  417.                    for the above mentioned expirations, empty user
  418.                    directories, etc.
  419.  
  420.                    Place in your nightly event.
  421.  
  422.                    Call Checkreq in the following manner:
  423.  
  424.                    CHECKREQ
  425.  
  426.   RBRAIN.EXE    -  Converts RomBrain RBF files into DreamROM DRF files.
  427.                    RBRAIN cannot be held responsible for the accuracy
  428.                    of the DRF file(s) made by this utility.  None of the
  429.                    files are checked for existance, size, date, etc.
  430.                    All information in the DRF file is taken from the RBF
  431.                    file.  If a file cannout be found, size or date is
  432.                    wrong, path it wrong, etc., it is NOT DreamROM nor
  433.                    RBRAIN's fault, but the fault of the RBF file.
  434.  
  435.                    NOTE:  A common problem with RomBrain RBF database is
  436.                    the first directory's name is partially deleted and
  437.                    on line 1.  You will need to fix this manually or
  438.                    you will NOT get an accurate DRF database!
  439.  
  440.                    The RBF with the error will look similar to this:
  441.  
  442.                    786253   cations
  443.                    FILENAME.ZIP 234,222 1-12-12
  444.  
  445.                    You need to edit it to look like:
  446.  
  447.                    786253
  448.                    *Communications
  449.                    FILENAME.ZIP 234,222 1-12-12
  450.  
  451.                    The first directory name MUST be on line 2 and MUST
  452.                    begin with a star (*).  Not editing as so will result
  453.                    in a DRF file that is NOT 100% accurate.  Most likely,
  454.                    the first directory will be skipped when listing.
  455.  
  456.                    Call RBrain in the following manner:
  457.  
  458.                    RBRAIN RBF SECLEVEL
  459.  
  460.                    ie:
  461.  
  462.                    RBRAIN C:\BRAINEX\ROMBRAIN\NOWL15.RBF 30
  463.  
  464.                    This would convert NOWL15.RBF to NOWL15.DRF in the
  465.                    current directory, setting all security levels to 30.
  466.  
  467.   ROMBULL.EXE      Creates and ansi and ascii bulletin of all online CDs.
  468.                    Path and name are as configured in the sysop section of
  469.                    Compile.   Used internally by DREAMROM.EXE.  Can also be
  470.                    used manually.  Also can make WC, PCB, ANSI, and ASCII
  471.                    listing of ALL CDRoms.
  472.  
  473.                    Call RomBull in the following manner:
  474.  
  475.   Help Screen      ROMBULL
  476.   Normal Bulls.    ROMBULL NORMAL
  477.   WildCat Cull.    ROMBULL WC PATH    (ie: ROMBULL WC C:\WC\BULLS\BULL9.BBS)
  478.   PCBoard Bull.    ROMBULL PCB PATH   (ie: ROMBULL PCB C:\PCB\BULL9.PCB)
  479.   ANSI Bull.       ROMBULL ANSI PATH  (ie: ROMBULL ANSI C:\BBS\DREAMROM.ANS)
  480.   ASCII Bull.      ROMBULL ASCII PATH (ie: ROMBULL ASCII C:\BBS\DREAMROM.ASC)
  481.  
  482.  
  483.    * DreamROM Setup
  484.  
  485.    Unzip DRMROMxx.ZIP into the directory you wish it to reside.  Run
  486.    SETUP to create DREAMROM.CFG. Then run COMPILE and the needed
  487.    subdirectories, files, etc will be created.
  488.  
  489.    While in COMPILE, press 'S' to configure DreamROM's Options.
  490.  
  491.    '1':  Update drive letters.  Enter the letters for ALL CD drives in
  492.          your system.  (ie:  E-J or EFGHIJ, etc..).
  493.  
  494.    '2':  Enter default CD drive and drive DR resides on.  The default CD
  495.          drive is usually the first CDRom drive in your system.  This
  496.          is the default bootup CDRom drive, and a CD that ALWAYS has a
  497.          CD in it.  The drive DR resides on is the drive you have
  498.          DreamROM installed upon.
  499.  
  500.    '3':  Sysop Security Level.  Enter your Sysop Security Level here.
  501.          Used for internal security, REQCOPY.EXE, and others.
  502.  
  503.    '4':  Setup Protocols.
  504.  
  505.          'L': List Existing Protocols
  506.          'A': Add a Protocol.  You will be asked for 3 things.  The
  507.               Protocol's Name, Batchfile Name (You're only allowed 4 letters
  508.               for the batchfile name.  Do NOT add the '.BAT' extension!
  509.          'D': Delete a Protocol.
  510.          'Q': Quit back to the Sysop Menu.
  511.  
  512.    '5':  # of days to keep requests.  This is the length of time you wish
  513.          to keep requested files on the HD before they are deleted.  (If
  514.          a person downloads the files, they are then deleted.  This keeps
  515.          forgotten requests from staying on your HD forever.)  Suggested
  516.          length is 7-14 days.  The default it 14 days.
  517.  
  518.    '6':  * DL bytes per day.  This is the limit users are allowed to
  519.            download per day.  (Bytes).
  520.  
  521.          * DL files per day.  This is the limit users are allowed to
  522.            download per day.  (Files).
  523.  
  524.          * Request files per day.  This is the limit users are allowed to
  525.            request per day.  (Files).  (This number isn't reset until the
  526.            user downloads the available requests.)
  527.  
  528.          * Request bytes per day.  This is the limit users are allowed to
  529.            download per day.  (Bytes).  (This number isn't reset until the
  530.            user downloads the available requests.)
  531.  
  532.          What this is for is, if the caller has a security level that isn't
  533.          defined in the Security setup, the files and bytes values will
  534.          default to this.
  535.  
  536.    '7':  Path and name to write online CD bulletins.  (Only written when
  537.          CDs are rescanned and CDINFO.DAT is re-written).
  538.  
  539.          CD bulletins are notices showning what CDs are online.
  540.  
  541.          ie:  C:\WC40\BULL\BULL1.SCR  or  DREAMROM.ANS
  542.               C:\WC40\BULL\BULL1.BBS  or  DREAMROM.ASC
  543.  
  544.          To force DreamROM NOT to create one of both files, place NUL as
  545.          the path and name.  (If you use RomBull to create a WC or PCB style
  546.          menu, you may wish to set both fields to NUL).
  547.  
  548.    '8':  Setup Security Levels.  You can define different security level
  549.          to have different file/bytes levels.  (Good for pay boards).
  550.  
  551.          'L': List Existing Security Levels and values
  552.          'A': Add a Security.  You will be asked for 3 things.  The
  553.               Security Level, DL Bytes, DL Files, Request Bytes, and Request
  554.               Files.
  555.          'D': Delete a Security Level
  556.          'Q': Quit back to the Sysop Menu.
  557.  
  558.    'A':  Add Comments.  Toggle on/off to add/not add comments to downloaded
  559.          files.  (ZIP and ARJ only).  COMMENT.TXT must be in the main
  560.          DreamROM directory.
  561.  
  562.          Hint:  The first line on the COMMENT.TXT should be a blank line.
  563.                 PKZip doesn't start the comment with a CR/LF like it
  564.                 should.  This'll make the comment look better. (Also, I
  565.                 suggest adding a CR/LF on the line after the comment, PKZip
  566.                 also has a thing about killing the last character on the
  567.                 last line.
  568.  
  569.          Ex Cmt:
  570.  
  571. ╔────────────────────────╦──────────────────────────────────────────────────╗
  572. │  ┌────┐        ┌────┐  │ 28.8  «« DreamNET  ■ 1:2230/146 Fidonet »»  2400 │
  573. │  │▒▒▒▒│ -----> │▒▒▒▒│  │                                                  │
  574. │ ┌╧════╧┐ <----┌╧════╧┐ │ Home of DreamWARE Communications Doors and Utils │
  575. │ └───═══┘ 28.8 └───═══┘ │ This file tested with the latest version of Scan │
  576. ╚────────────────────────╩──────────────────────────────────────────────────╝
  577.  
  578.  
  579.    'C':  Compresssion.  Toggle on/off to use/not use compression on the
  580.          DRF files.  PKZip/PKUnzip are used for the compression.  This
  581.          will save you a LOT of space, especially if you have a lot of DRF
  582.          files.  Uncompression time depends on your system.  (CPU, Cache,
  583.          etc)
  584.  
  585.    'L':  Auto_Logoff.  Toggle on/off to allow/not allow users to
  586.          automatically logoff after download.
  587.  
  588.    'S':  Spawning.  Toggle on/off to use/not use spawning.  Using it is
  589.          recommended.  Toggle to off if users complain of loss of control
  590.          from remote.  (Happens sometimes under DesqView.  DV doesn't like
  591.          some programs that spawn out.)
  592.  
  593.    'W':  Work directory.  Defaults as current directory.  This is where all
  594.          DRFs are copied to, as well as all work files/directories, and
  595.          files copied from the CD to the HD for download.  This is useful
  596.          for systems running a LAN to keep the workstation free, or if
  597.          you're HD is running low and want DreamROM to work on a free HD.
  598.          (And other reasons).
  599.  
  600.    'R':  Register DreamROM.   Enter your Registered SysopName, BBSName,
  601.          and Number here, when registered.
  602.  
  603.    'Q':  Quit to main.
  604.  
  605.  
  606.    * How to compile/create a DreamROM Filebase (DRF)
  607.  
  608.    DreamROM needs to know about the files on your CDRom... All the
  609.    data is stored in a single file with an .DRF extension.
  610.  
  611.    Following these steps to compile a DRF:
  612.  
  613.  
  614.    Place the cd-rom into your default drive.
  615.  
  616.    Take a look at the disk, directories, etc.. and see which files
  617.    contain the descriptions of the CDRom files. These are usually
  618.    named FILES.BBS, and are located in each CDRom directory that
  619.    contains files for users to download.  (If a description file
  620.    doesn't exist, the file names/sizes/dates are read into the DRF,
  621.    but there will be no descriptions.  These aren't very common,
  622.    but DO show up every now and again.  Also, check to see if there
  623.    is a \PCBTEXT directory, if so, this will speed up the compile a
  624.    bit.
  625.  
  626.    Now that you have found the names of the description files, you are
  627.    ready to begin the compile.
  628.  
  629.    Run COMPILE.
  630.  
  631.      '1':  Enter your CDRom work drive.  (Whichever CDRom drive your CD
  632.            is in.  Changing this option ONLY affects COMPILE.
  633.  
  634.      '2':  Enter description file.  Usually FILES.BBS.  If the dir
  635.            \PCBTEXT directory exists, place PCBTEXT here.
  636.  
  637.      '3':  Create filelists.  You will be prompted for a minimum security
  638.            level.  This the the LOWEST security level that will be able to
  639.            view the directories, files, and download files/filelists on
  640.            this CDRom.  Each directory on the CD has it's own security
  641.            level, but when the database is created, ALL directories will
  642.            have this security level.  Directory security levels will be
  643.            looked at in detail later in this file.
  644.  
  645.            COMPILE now scans the CD and creates 2 files:  FILES.LST and
  646.            DIRS.LST.
  647.  
  648.            FILES.LST:
  649.  
  650.             Each line describes a directory on your CD.  Each line has
  651.             three sections separated by semi-colons (;).  COMPILE does
  652.             not know how to describe each directory/category, so it will
  653.             use the directory name as the description. If you would like
  654.             to edit these descriptions, follow the directions below in
  655.             '4':.  Editing IS recommended for user clarity.
  656.  
  657.            DIRS.LST:
  658.  
  659.              Each line is a path to a directory on your CD.  Follow the
  660.              directions below in '5': for editing purposes.
  661.  
  662.  
  663.      '4':  Edit FILES.LST.  (You may also quit COMPILE and use your
  664.            favorite texteditor to edit this file).
  665.            Below is a sample FILES.LST.
  666.  
  667.             [ROOT];E:\;30;E:\
  668.             001A;E:\001A;30;E:\001A\FILES.BBS
  669.             002A;E:\002A;30;E:\002A\FILES.BBS
  670.             003A;E:\003A;30;E:\003A\FILES.BBS
  671.             004A;E:\004A;30;E:\004A\FILES.BBS
  672.  
  673.             Take out all directories you do NOT want compiled into the
  674.             database.  (ie:  ROOT, empty directories, directories that
  675.             contain filelists only, etc.  REMEMBER what directories you
  676.             delete!  You will need to delete the same ones in DIRS.LST.
  677.  
  678.             To name the directories/categories, edit the first field
  679.             in each line.  (The text preceeding the first semi-colon.
  680.             Do NOT edit the second field.  The third field is the security
  681.             level required to access this directory.  Edit to desired
  682.             level, if the default level isn't correct.  (This is good
  683.             for CDs such as Busty Babes 2, which is 1/2 Adult and 1/2
  684.             shareware.  The fourth field is the path to the description
  685.             file.  Change this if this is NOT the path.  (ie:  Some CDs
  686.             have files such are DIR1.TXT, DIR2.TXT, etc.. in their own
  687.             directory.  For CDs that use this method, edit the fourth
  688.             field to reflect the path and filename of the description
  689.             files.)
  690.  
  691.             After editing, your FILES.LST will look similar to this:
  692.  
  693.             Animations;E:\001A;30;E:\001A\FILES.BBS
  694.             Archivers;E:\002A;30;E:\002A\FILES.BBS
  695.             BBS Doors;E:\003A;30;E:\003A\FILES.BBS
  696.             BBS Programs and Utilities;E:\004A;30;E:\004A\FILES.BBS
  697.  
  698.  
  699.      The first field is the name of the directory/category.
  700.      The second field is the actual directory name/path.
  701.      The third field is the security level for this directory/category.
  702.      Each field is separated by a semi-colon.
  703.  
  704.            This step in unneeded if you entered PCBTEXT as the
  705.            description file.
  706.  
  707.      '5':  Edit DIRS.LST.  (You may also quit COMPILE and use your
  708.            favorite texteditor to edit this file).
  709.            Below is a sample DIRS.LST
  710.  
  711.             E:\
  712.             E:\001A
  713.             E:\002A
  714.             E:\003A
  715.             E:\004A
  716.  
  717.           Delete the same directories you deleted in FILES.LST.  (You did
  718.           remember which ones, right? <g>)
  719.  
  720.            This step in unneeded if you entered PCBTEXT as the
  721.            description file.
  722.  
  723.      '6':  Create Filebase.  A screen will pop up with a line, a measure
  724.            bar, and an arrow.   Use your right and left arrow keys to move
  725.            the arrow to the position where you want the description line to
  726.            start, and press enter.  Normally, this is the first letter of the
  727.            description line for example, you may get a display similar to
  728.            this:
  729.  
  730.      DRMROM13.ZIP  315,900   12/31/94 | DreamROM v1.3 - The ULTIMATE CDRom
  731.      0........1.........2.........3.........4.........5.........6.........7
  732.      ^                                  $
  733.  
  734.            Use the right and left arrow keys to move the arrow (^) to the
  735.            desired position, which normally would be where the $ is located.
  736.            (DreamROM will place it's own pipe (|) symbols where needed.)
  737.            This will filter out the filesize and filedate in the description
  738.            files, as DreamROM gets that information directly from the file
  739.            on the CD.   Not all description files have the date and time in
  740.            them, like below:
  741.  
  742.      DRMROM13.ZIP  DreamROM v1.3 - The ULTIMATE CDRom Access Door!  Let you
  743.      0........1.........2.........3.........4.........5.........6.........7
  744.      ^             $
  745.  
  746.            Therefore, you would move the arrow to where the $ is indicated
  747.            to select that as the starting position of the description file.
  748.  
  749.            Next, you will be asked for a name for the DRF file.
  750.            This will then scan your CD, gets files, sizes, dates, locations
  751.            and descriptions.  The time the compile takes depends on your
  752.            system, the CD size, etc.  Most CDs on my 386DX40 with 8Megs
  753.            RAM and a 2 Meg cache take approx. 15 minutes to compile. When
  754.            COMPILE has completed compiling the DRF file, it will let you
  755.            know by playing a song.  :)
  756.  
  757.      '7':  Add CD to database.  This is where you put the CD info into
  758.            DreamROMs database, so DreamROM will know how to determine
  759.            which CD is in which CDRom drive.  You also put the name of
  760.            the CDRom here, along with other info.
  761.  
  762.            The configuration screen is similar to this:
  763.  
  764.  
  765.     +-----------------[■ DreamROM CDRom Configuration ■]------------------+
  766.     |                                                                     |
  767.     |    CD #     CD Title                                                |
  768.     |    1        Night Owl BBS                                           |
  769.     |                                                                     |
  770.     |    CD Identifier                                                    |
  771.     |    NOP_BBS;001A;04-17-94;11:08p                                     |
  772.     |                                                                     |
  773.     |    CD Filename       Access Sec.    Download Sec.    Deleted?       |
  774.     |     NOWLBBS.DRF       30              30             No             |
  775.     |                                                                     |
  776.     |                                                                     |
  777.     +---------------------------------------------------------------------+
  778.  
  779.  
  780.      [UP Arrow] Up One Field     [DOWN Arrow] Down One Field     [F2] Save
  781.          [RIGHT Arrow] Up One Record     [LEFT Arrow] Down One Record
  782.      [ESC] Quit Without Saving  [INS] Enter New CD  [DEL] Delete This CD
  783.  
  784.            If this is the first CD you've compiled, this screen will come
  785.            up with bogus information inserted into the fields.  You may edit
  786.            this record.  If this is NOT a new CD, press INSERT to create
  787.            a new record, and edit the new record.
  788.  
  789.            The cursor will begin on the CDRom Name field.  Press Enter
  790.            and enter the CD's name.  (ie: Night Owl 13).  Next hit the
  791.            down arrow to move to the CD Identifier (CDI) field.  First,
  792.            be sure the CD is in the work drive, then press ENTER.
  793.            COMPILE will access the CD and gather some information about
  794.            it.  The CDI will look similar to this:
  795.            VOLUME;FIRST_DIR;DIR_DATE;DIR_TIME;
  796.            next, hit the down arrow again, press ENTER and enter in
  797.            the filename you used when you compiled the DRF file.  Do NOT
  798.            add the .DRF or .ZIP extension!  FILENAME.DRF is first searched
  799.            for, then FILENAME.ZIP.  If neither exist, COMPILE will let you
  800.            know and prompt you to enter a new name.  After entering the
  801.            filename, press the down arrow once again, press ENTER, and
  802.            enter the lowest security level allowed to access this CD.
  803.            Then press the down arrow one last time and press ENTER.
  804.            Now enter the lowest security level allowed to download from
  805.            this CD.  After all fields are entered, press F2 to save the
  806.            entry.  That's it!  Press ESCAPE to return to the main menu.
  807.  
  808.    * Editing a DRF file
  809.  
  810.    DRF files are plain straight ASCII text files.
  811.  
  812.    You can edit a DRF file with any texteditor/word processor. Note
  813.    that the editors must be able to load large textfiles!  Do NOT change
  814.    the first line of the DRF file. This stores an index number required
  815.    by DreamROM.
  816.  
  817.    If at any point you feel you have messed up a DRF file, DO NOT PANIC!
  818.    Just run FIX.EXE, and the file will be rebuilt.
  819.  
  820.    * Structure of a DRF file
  821.  
  822.    The first line stores the index number to the starting line number
  823.    of data section of the file.
  824.  
  825.    Each category line starts with a ■ (ALT-254) character such as:
  826.  
  827.    ■BBS Doors;30
  828.  
  829.    The 30 is the security level for this directory/category
  830.  
  831.    File descriptions begin with the filename, path and filename, size,
  832.    and date
  833.  
  834.    DRMSLT15.ZIP;\016A\DRMSLT15.ZIP;93050;02/23/94
  835.  
  836.    Description lines begin with a | character:
  837.  
  838.    | +---------- DreamSLOTS  v1.5 ----------+
  839.    | |o    The ULTIMATE in Online Slot     o|
  840.    | |  ==========  Machines! ============  |
  841.    | | 100% ANSi Grafix.  Can YOU Become A  |
  842.    | | Billionaire & Join The Bill' Club??  |
  843.    | |  Supports all the most popular BBS'  |
  844.    | |        Multi-node capable!!          |
  845.    | |  NOT CRIPPLED!!!   $10 Registration  |
  846.    | |o   A MUST SEE !!   Read WHATS.NEW   o|
  847.    | +------ DreamWARE Communications ------+
  848.  
  849.    At the end of the file is the data section:
  850.  
  851.    **END
  852.    PCBoard Programs & Utilities;30;2
  853.    PCBoard PPEs;30;897
  854.    Wildcat!;30;2722
  855.    VBBS;30;3129
  856.    WWIV;30;3209
  857.    RBBS;30;3277
  858.    Remote Access;30;3831
  859.  
  860.  
  861.    The first field in the line is the directory/category name.
  862.    The second field is the security level for the directory/category.
  863.    The last field is the line number the section for this directory/
  864.    category starts on.
  865.  
  866.    The numbers will be rebuilt when you run FIX after an edit,
  867.    so ignore them!
  868.  
  869.    To delete a specific file from the database, set the filesize to 0
  870.  
  871.    You can permanently delete any file, category, or description
  872.    by editing it out of the DRF file.
  873.  
  874.    ***** ALWAYS run FIX.EXE after you edit a DRF File!!!
  875.  
  876.    * NOTE
  877.     Many pre-compiled DRF files are available from DreamNET, Arti BBS and
  878.     INDY * X.  If you download a pre-compiled DRF, just unzip it into
  879.     the CDS subdirectory, run NEWSEC from the main DreamROM subdirectory
  880.     to convert it to the desired security level.  You must then add it into
  881.     the database so DreamROM will know it exists.
  882.  
  883.  
  884.    * Copying Files
  885.  
  886.    DreamROM will create a file named INUSE.$ in the DreamROM main directory.
  887.    When present, other nodes must wait until this file is deleted by
  888.    the node that is accessing the cd-rom drive. If for some reason
  889.    you rebooted the machine before this file is removed, DreamROM
  890.    will not be able to copy files. You will see a notice stating the
  891.    drive is in use. To fix this, simply delete INUSE.$ to restore
  892.    normal operation.  Also, if this happens, or a complete lockup occurs,
  893.    check in the DATA subdirectory for a file names BUSY.$$$ and delete it.
  894.    This will also return normal operation.  (BUSY.$$$ is created when a node
  895.    writes to a datafile.. this prevents conflicts and)
  896.  
  897.    * CDRom List / Scan Mode
  898.  
  899.    Information about all CDs (Online and Offline) are kept in a small
  900.    index file called CDINFO.DAT.  The format is as follows:
  901.  
  902.     Top Drawer;30;ON;9;E
  903.     Night Owl 13;30;ON;2;F
  904.     Night Owl 12;30;OFF;3;
  905.     Night Owl 11;30;OFF;4;
  906.     Night Owl 10.1;30;OFF;5;
  907.     Night Owl 10;30;OFF;6;
  908.     Pier 4;30;OFF;1;
  909.  
  910.     CDName;Seclevel;Status;CDRec#;Drive
  911.  
  912.     CDName   <=  Name of CD as entered in COMPILE
  913.     Seclevel <=  Minimum Security Level allowed to access this CD
  914.     Status   <=  ON = Online  OFF = Offline
  915.     CDRec #  <=  Record # CD is in DREAMROM.DAT.  Faster loading.
  916.     Drive    <=  Drive letter CD is in.  Blank if offline.
  917.  
  918.    DreamROM will only scan the drives if CDINFO.DAT does NOT exist.  To
  919.    force DreamROM to rescan the drives, simply delete CDINFO.DAT.
  920.    (The bulletins will then be created.)
  921.  
  922.  
  923.    * Log File
  924.  
  925.    Logs of DreamROM activity are saved in the LOGS subdirectory, in a
  926.    file called ROMLOG.x, where x is the nodenumber.
  927.  
  928.  *** Errors / Problems / Etc...  Read DREAMROM.FAQ for Frequently Asked
  929.                                  Questions, etc...
  930.  
  931.     * Support
  932.  
  933.      You may obtain assistance with a DreamWARE Communication programs and
  934.      related problems by calling DreamNET at (813)362-9440 and leave a
  935.      comment to Andy Stewart.  You may also find the latest versions of
  936.      DreamWARE Communications doors here, which are downloadable on
  937.      the first call. Also, they can be found on the support boards found
  938.      in DISTRIB.TXT  You may also email me at 1:2230/146 Fidonet.
  939.  
  940.  
  941.      * Registration
  942.  
  943.      Registration of DreamROM is only $25.00.  Please use the form in the
  944.      file ORDER.FRM.   When you register DreamROM, you will receive a
  945.      keycode to turn your copy of DreamROM into a registered version.  More
  946.      information on this is in ORDER.FRM.
  947.  
  948.      This version of DreamROM is NOT a DEMO.  File Transfers and Requests
  949.      are only limited to what the sysop has setup.
  950.  
  951.  
  952.      * Special Thanx (Probably time to change these, but after coding,
  953.                       my fingers are pooped.)
  954.  
  955.       Special thanx go the the following 7 guys.  They tested the 'ell
  956.       outta DreamROM, and without them, I'd still be sitting in front of
  957.       the monitor, with everything from my waist-down asleep, STILL trying
  958.       to find that last bug!  Thanx TONS guys!!!
  959.  
  960.      Dwight Dawson :
  961.        The guy who got me to start on this.  Seems there was ALWAYS
  962.        something wrong with the 'other' package you were running, so
  963.        we HAD to do something about it.  Mr. OS/2.  Runs sweet under
  964.        it, huh!? <g>  Thanx for getting me started on this!
  965.  
  966.      Dan Taylor :
  967.        Dan, Dan the CD Man.  (Now THAT was corny!).  What, 70 CDs and
  968.        counting?  Can't let Dwight catch up with ya!  You can find a bug
  969.        that would only show on the second Tuesday in March, under a full
  970.        moon and a tornado on the horizon! <g>  Thanx for the bugs! ;)
  971.  
  972.      William Morgan :
  973.        Mr. Guinea Pig.  Lets see, how many times did I/we crash your
  974.        machine? <g>.  4 Pioneers, geez, if it'll run there, it'll
  975.        run anywhere. Thanx mon, I promise no more 4am lockups!!
  976.  
  977.      Rob Williams :
  978.        My 'code partner'.  Thanx for all the code you've shipping my
  979.        way, and for answering all my "how the 'ell do you do this?"
  980.        questions.  How many times did I type WHAT in the dox? <g>
  981.  
  982.      Randy Lewenza :
  983.        My Canadian buddy!  How's it going', eh? <g>  Shaddap, I do NOT
  984.        sleep all the time!! <g>.  Thanx for pushing it up in the Great
  985.        White (Freezin') North!
  986.  
  987.      Ed Georgen :
  988.        The second newest beta guy.  Got in on it at the end of the testing.
  989.        It was short, but sweet!  Thanx!  (Thanx for testing Order 1.8
  990.        for me! You were my main tester for it! <g> )
  991.  
  992.      Tim Brown :
  993.        The newest beta/distribution guy.  Thanx for letting me use your
  994.        system as the main support board while I get things straightened
  995.        out during (yet) another move!
  996.  
  997.  
  998. Most of all, thanx to Steph and Nikki!   Yeah Guys, I'm coming to bed tonight!
  999.  
  1000.  
  1001.                   Thank you for using DreamROM! and Enjoy!
  1002.                        -----------------------------
  1003.  
  1004.                                   Andy
  1005.